home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / pascal / totsrc11.zip / README < prev    next >
Text File  |  1993-05-04  |  26KB  |  576 lines
  1.                   WELCOME TO TECHNOJOCK'S OBJECT TOOLKIT
  2.                   --------------------------------------
  3.  
  4.   This README file contains important information about TechnoJock's
  5.   Object Toolkit (TOT) version 1.10. For the latest information about
  6.   TOT, the accompanying programs and the manual, read this file in
  7.   its entirety. To print this file, just press T and specify a printer
  8.   port or a filename.
  9.  
  10.  
  11.                   TABLE OF CONTENTS
  12.                   -----------------
  13.                   1.  Usage Hints
  14.                   2.  Using the Demos
  15.                   3.  TOT Enhancements and Undocumented Features
  16.                   4.  The Norton Guides TOT Database
  17.                   5.  Files on the Disks
  18.                   6.  Shareware
  19.                   7.  Printing the Manual
  20.                   8.  Installation
  21.                   9.  Association of Shareware Professionals
  22.  
  23.               +----------------------------------------------+
  24.               |  P a r t   1    -    U s a g e   H i n t s   |
  25.               +----------------------------------------------+
  26.  
  27. Many of you will want to start using the Toolkit immediately. However, we
  28. really do recommend that you read the first three chapters of the User's 
  29. Manual before you start coding. Ideally, you should read the entire 
  30. manual - after all, we wrote it in the hope that you would!
  31.  
  32. If you insist on using the Toolkit without reading the documentation, at 
  33. least follow these hints:
  34.  
  35.    1)  The Toolkit includes the following, globally declared and initialized
  36.        objects:
  37.  
  38.               SCREEN       - for writing to the visible screen
  39.               KEY          - for accessing the keyboard
  40.               MOUSE        - for controlling the mouse location and shape
  41.               MONITOR^     - a POINTER to an object controlling display 
  42.                              characteristics
  43.               LOOKtot^     - a POINTER to an object controlling default 
  44.                              colors, etc. 
  45.               SHADOWtot^   - a POINTER to an object controlling shadow
  46.                              characteristics
  47.               SCROLLtot^   - a POINTER to an object controlling scroll bar
  48.                              characteristics
  49.               DATEtot^     - a POINTER to an object controlling date
  50.                              characteristics
  51.               IOtot^       - a POINTER to an object controlling the form
  52.                              input defaults
  53.               ALPHABETtot^ - a POINTER to an object controlling how the
  54.                              TOOLKIT manipulates upper- and lower-case chars
  55.  
  56.    2)   If you create any other object instances (i.e. variables), make
  57.         sure you call the INIT method before any others, and the DONE method
  58.         when you are finished. The following code fragment illustrates how you
  59.         could use the ScreenOBJ object to save and restore the visible screen:
  60.  
  61.              var  SaveScreen: ScreenOBJ;
  62.              begin
  63.                 SaveScreen.Init;
  64.                 SaveScreen.Save;
  65.                 {...}
  66.                 {other procs which write to the screen}
  67.                 {...}
  68.                 SaveScreen.Display;
  69.                 SaveScreen.Done;
  70.              end;
  71.  
  72.         IMPORTANT NOTE: don't call the INIT and DONE methods for the
  73.         global instances described in hint 1).
  74.  
  75.    3)   Enable the FINAL directive in the TOTFLAGS.INC file to minimize
  76.         program size.
  77.  
  78.    4)   Run the demos to see how each unit can be used (discussed next).
  79.  
  80.             +---------------------------------------------------+
  81.             |  P a r t   2    -    U s i n g  t h e  D e m o s  |
  82.             +---------------------------------------------------+
  83.  
  84. There are over 80 demo programs in the Toolkit. The majority of these 
  85. demos are designed to illustrate a specific finite part of the Toolkit. They 
  86. are referred to at the appropriate places in the documentation. Listed below 
  87. is a summary of the demo files:
  88.  
  89.                      DEMBR1-5    Browse demos   
  90.                      DEMBX1-3    Box demos
  91.                      DEMCU1      Cursor demo
  92.                      DEMDR1-7    Directory demos
  93.                      DEMDT1-2    Date demos
  94.                      DEMEX1-2    DOS EXEC demos
  95.                      DEMFS1-2    Screen writing demo
  96.                      DEMIN1-4    Keyboard and mouse input demo
  97.                      DEMIO1-24   Form Input demos
  98.                      DEMLK1-2    Link list demos
  99.                      DEMLS1-9    List demos
  100.                      DEMMN1-9A   Menu emos
  101.                      DEMMS1-8    Message demos
  102.                      DEMOV1-2    Overlay demos
  103.                      DEMSC1      Scroll bar demo
  104.                      DEMSH1      Shadow demo
  105.                      DEMST1-3    String demos
  106.                      DEMSY1      System demo
  107.                      DEMVI1      Virtual screen demo
  108.                      DEMWI1-4    Window demos
  109.                      DEMWR1      Screen writing demo
  110.                      EXTDEM1-8   Extension demos
  111.                      TOTDEMO     Overall Demo
  112.  
  113. If your goal is to appreciate the power of the Toolkit, then consider 
  114. running the following demos (as well as being educational, they have visual 
  115. impact):
  116.                       TOTDEMO
  117.                       DEMIO21,22
  118.                       DEMLS9
  119.                       DEMMN9
  120.                       DEMBR5
  121.  
  122. A special thank-you to George Butts and George Bean, two Toolkit users who
  123. have generously given us some programs they developed with the Toolkit. Try 
  124. running the programs
  125.           
  126.                      TBROWSE
  127.                      TELE
  128.  
  129. to see how easy the Toolkit is to use!
  130.   
  131.  
  132.               +-----------------------------------------------+
  133.               |  P a r t   3    -    E n h a n c e m e n t s  |
  134.               +-----------------------------------------------+
  135.  
  136. This section identifies any last minute changes that have been made since
  137. the documentation was printed. The following topics are discussed:
  138.  
  139.                   1) International Customization
  140.                   2) Additions to totMISC
  141.                   3) Key Constants
  142.                   4) Further IO Extensions
  143.                   5) Additional Methods
  144.                   6) Overlaying the Toolkit
  145.  
  146. 1) INTERNATIONAL CONSIDERATIONS
  147. ===============================
  148. The TOTIO2.PAS unit includes the following declarations:
  149.  
  150.    CONST
  151.    NumberError: array[1..2] of string[60] =
  152.    (' The number you entered is out of range. ',
  153.     ' Enter a number in the following range: ');
  154.    DateError: array[1..6] of string[60] = 
  155.    (' The date you entered is invalid. ',
  156.     ' Enter a date in the format:',
  157.     ' The date you entered is too early. ',
  158.     ' The earliest acceptable date is: ',
  159.     ' The date you entered is too late. ',
  160.     ' The latest acceptable date is: ');
  161.  
  162. NumberError is an array of strings with two elements. These two elements
  163. represent the text that is displayed if an out-of-range value is
  164. entered in an IO field. 
  165.  
  166. DateError is an array of strings with six elements. This array includes
  167. three pairs of strings which represent the various messages which are
  168. displayed when an invalid or out-of-range date is entered in a date field.
  169.  
  170. Similarly, the totLINK unit includes the following declaration:
  171.   Const
  172.   NoFiles: string[20] = 'No Files';
  173.  
  174. The text is displayed in directory listings when no file is found.
  175.  
  176. You may customize these messages as necessary.
  177.  
  178. Refer to the Toolkit documentation on AlphabetTOT and DateTOT for other
  179. customization considerations.
  180.  
  181.  
  182. 2) ADDITIONS to TOTMISC
  183. =======================
  184. The following procedures and functions have been added to the totMISC
  185. unit, and are not discussed in the manual:
  186.  
  187.   function  DeleteFile(Filename:string): shortint;
  188.        Deletes a file from the disk, and returns a shortint code as
  189.        follows:     -1    File not found
  190.                      0    File deleted
  191.                      1    Error - file not deleted.  
  192.  
  193.   function  RenameFile(Oldname,NewName:string):shortint;